Notion MCP
Learn how to connect AI agents to your Notion workspace.
The Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context and tools to large language models (LLMs).
Try the new Notion MCP (Beta)
We’ve introduced Notion MCP, a remote MCP server that includes the latest tools tailored to AI agents.
This version is remotely hosted by Notion and built to be more token-efficient, AI-optimized, and easier to use than our open-source server. To save on consumption of LLM context tokens, Notion MCP uses an enhanced flavor of Markdown to represent blocks, pages, and databases, resulting in more condensed results than the v1 API's traditional JSON block rendering.
📘 Read the Beta Overview: Notion MCP to:
- Learn how to get started
- Understand the available tools
- Share feedback to help shape what comes next
We’d love for you to try it out and let us know what’s working and what could be improved.
Hosting the open-source MCP server
If you’d rather run your own MCP server, the notion-mcp-server package is our open-source implementation. It offers more control over setup and behavior, and is a great fit for teams who already have an existing Notion integration or prefer to manage infrastructure themselves.
Compared to Notion’s remote MCP, this option requires more technical setup, including provisioning your own Notion integration and handling deployment. But it also gives you full visibility, support for the original JSON-based v1 APIs, and the flexibility to customize capabilities as needed.
Our MCP server works with any MCP client. Select one that best fits your needs and use cases. Examples of supported MCP clients are listed here.
→ Explore the GitHub repo to get started.
Updated 15 days ago